home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / lanmodm1.zip / TESTNET.DOC < prev    next >
Encoding:
Text File  |  1989-11-15  |  14.3 KB  |  397 lines
  1.  
  2.                                     TESTNET
  3.                       Utility for Testing NetBIOS Networks
  4.                                November 13, 1989
  5.                            CROSS Information Company
  6.  
  7.           Forward.
  8.           Several NetBIOS networks are not very stable and do not
  9.           provide a correct NetBIOS emulation. This utility will allow
  10.           one to test the network to verify that MCOM, UCOM, and
  11.           NETDEV will operate correctly within the network environ-
  12.           ment. Using this utility, one can simulate modem I/O over-
  13.           night to verify that the network will not "hang up" on the
  14.           procedure and that the systems involved will not crash.
  15.  
  16.           Using TESTNET.
  17.           Find some workstation on your system that has a communica-
  18.           tions adapter port (COM port). You must use a COM port even
  19.           though you normally intend to use internal modems. Verify
  20.           that the COM port operates correctly by using any ordinary
  21.           "smart-terminal" program to access the port. You can do this
  22.           by connecting a lead between the RS-232C terminals 2 and 3.
  23.           This connects the transmit and receive leads together. When
  24.           you type something on the keyboard, it should immediately
  25.           echo on the screen. If your "smart-terminal" program does
  26.           not echo characters, it probably means that the IRQ (inter-
  27.           rupt request) lines are not enabled on the communications
  28.           adapter card. Verify that COM1 uses IRQ4 and COM2 use IRQ3.
  29.           After you have your communications adapter port operating
  30.           correctly, leave the jumper between terminals 2 and 3 of the
  31.           RS-232C connector and then load MCOM on the workstation.
  32.  
  33.           Using any other workstation on your system, execute TESTNET.
  34.           The program should find the "COMM01" device and begin to do
  35.           I/O with the MCOM device-driver.
  36.  
  37.           ╔═════════════════════════════════════════════════╗
  38.           ║ TESTNET  NetBIOS Network Testing Utility  V1.01 ║
  39.           ║  Copyright (c) 1989  Cross Information Company  ║░░░
  40.           ║   All rights reserved worldwide.   Ser  12345   ║░░░
  41.           ║   Phone (303) 444-7799    FAX (303) 444-4687    ║░░░
  42.           ║                                                 ║░░░
  43.           ║   Check network : Okay                          ║░░░
  44.           ║        Add name : Okay                          ║░░░
  45.           ║       Call name : Okay                          ║░░░
  46.           ║       Send data : Okay                          ║░░░
  47.           ║    Receive data : Okay                          ║░░░
  48.           ║      Check data : Okay                          ║░░░
  49.           ║   Send datagram : Okay                          ║░░░
  50.           ║   Recv datagram : Okay                          ║░░░
  51.           ║      Last error :                               ║░░░
  52.           ║    Total errors : 0                             ║░░░
  53.           ║      Total data : 12,799,872                    ║░░░
  54.           ║         Hang up : Okay                          ║░░░
  55.           ║     Delete name : Okay                          ║░░░
  56.           ╟─────────────────────────────────────────────────╢░░░
  57.           ║ Re:0000 Ab:004A Co:004F Tx:0FE1291A Rx:0FE11A9B ║░░░
  58.           ╚═════════════════════════════════════════════════╝░░░
  59.              ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                      - 1 -
  67.  
  68.                                                         TESTNET Page 2
  69.  
  70.  
  71.           You can also force a specifc device-driver to be called. You
  72.           put it's name on the command-line:
  73.  
  74.                 TESTNET COMM01  (Calls device COMM01)
  75.                 TESTNET COMM02  (Calls device COMM02)
  76.  
  77.           The following errors can be returned by TESTNET:
  78.  
  79.           Bad local session number:
  80.                 An error occurred within NetBIOS that forced the
  81.           termination of a session. No such information was reported
  82.           to TESTNET by NetBIOS so the very first indication that a
  83.           session had been aborted was when NetBIOS refused to accept
  84.           any more commands from the local session number.
  85.  
  86.           Can't cancel command:
  87.                 An attempt was made to cancel a command that had
  88.           either already completed or was not allowed to be canceled.
  89.           Because TESTNET only cancels one command (the CALL, if
  90.           COMM01 is busy), and since the cancel is legal, If you get
  91.           this error, your NetBIOS is returning errors not intended
  92.           for TESTNET.
  93.  
  94.           Can't find name:
  95.                 A CALL was made to a named device but there was no
  96.           response from the device. Either the device does not exist
  97.           or it was busy. This is normal if you don't have the MCOM
  98.           driver installed on a net-station somewhere on the local
  99.           network.
  100.  
  101.           Command canceled:
  102.                 A CANCEL command was executed successfully. This
  103.           should not appear because TESTNET does not issue any CANCEL
  104.           commands after a session has been established.
  105.  
  106.           Command not canceled:
  107.                 A CANCEL command failed to execute properly. TESTNET
  108.           does not issue any cancel commands after a session has been
  109.           established.
  110.  
  111.           Command timed out:
  112.                 A timeout on a RECEIVE or SEND command occurred. If a
  113.           timeout occurs during a send, the session is aborted. Time-
  114.           outs during receive are normal if there are no data being
  115.           received.
  116.  
  117.           Data error:
  118.                 The data received were not exactly the same as the
  119.           data sent.
  120.  
  121.           Duplicate name:
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                                      - 2 -
  133.  
  134.                                                         TESTNET Page 3
  135.  
  136.                 An attempt was made to ADD NAME when the name was
  137.           already in use. Since TESTNET always uses a new unique-name
  138.           obtained by converting the system timer-tick into a hexa-
  139.           decimal character string, no duplicate names are possible
  140.           unless more than one copy of TESTNET is executing on the
  141.           network at one time.
  142.  
  143.           Illegal buffer length:
  144.                 The length of either an output or input buffer was too
  145.           long for the command. Since TESTNET always uses the correct
  146.           buffer-length which is fixed, not a variable, this error
  147.           should never occur.
  148.  
  149.           Illegal name-number:
  150.                 The session was aborted. The name-number no longer
  151.           exists. Something caused the session to be aborted. The fact
  152.           that the session had been aborted was not transmitted to
  153.           TESTNET so it continued to attempt to communicate with the
  154.           MCOM driver. The result was this error-code being returned.
  155.           A properly designed NetBIOS would inform a session that
  156.           communication has been lost so this error would never occur.
  157.  
  158.           Incompatible remote device
  159.                 Some hardware on the network is not responding cor-
  160.           rectly when addressed. This can be caused by noise on the
  161.           network.
  162.  
  163.           Interface busy:
  164.                 A SEND or RECEIVE command encountered a very busy
  165.           network. The commands will be retried.
  166.  
  167.           Invalid command:
  168.                 Some data-corruption has occurred, destroying the
  169.           network control-block. This is usually caused by a stack
  170.           overflow. Entering STACKS=15,255 in the CONFIG.SYS file may
  171.           help.
  172.  
  173.           Invalid NCB_LANA_NUM:
  174.                 Two NetBIOS programs are resident in memory. The wrong
  175.           one is being addressed. Check your network configuration.
  176.  
  177.           Local session table full:
  178.                 Two many sessions have already been started. There is
  179.           no more room. Reconfigure the network with more sessions
  180.           defined. This can also happen when NetBIOS pretends to
  181.           delete a name from the local name-table while in fact the
  182.           name remains, using a necessary slot.
  183.  
  184.           Locator not responding:
  185.                 The master station (if any) has gone off-line. If you
  186.           don't have a master-station the error-code probably means
  187.           that the CALLed name can't be located.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                                      - 3 -
  199.  
  200.                                                         TESTNET Page 4
  201.  
  202.  
  203.           Message incomplete:
  204.                 Data during a RECEIVE has been truncated because of a
  205.           buffer overflow. This can happen if the network is very busy
  206.           and the data-buffer length in the network configuration was
  207.           not correctly chosen. The buffer length is normally a
  208.           multiple of 1k (1024 bytes).
  209.  
  210.           Name conflict detected:
  211.                 An attempt was made to ADD NAME to the local session
  212.           table when the name was in use somewhere else on the net-
  213.           work. Since TESTNET guarantees a unique name, this should
  214.           never happen unless TESTNET is executing somewhere else on
  215.           the network.
  216.  
  217.           Name de-registered
  218.                 An attempt was name to DELETE NAME from the local
  219.           session table while a command was outstanding. When the
  220.           command completes, the same should be deleted. Experience
  221.           shows that the name will never be deleted and you will have
  222.           lost a slot in the name-table.
  223.  
  224.           Name deleted:
  225.                 A CALL or HANGUP command was made to a name that was
  226.           already deleted. This could happen if a net-station has gone
  227.           off-line forcing a session to be terminated.
  228.  
  229.           Name is in use:
  230.                 An attempt was made to ADD NAME to the local session
  231.           table when the name is in use locally.  Since TESTNET
  232.           guarantees a unique name, this should never happen unless
  233.           TESTNET is executing somewhere else on the network.
  234.  
  235.           Name not found:
  236.                 The CALLed name was not present probably because MCOM
  237.           was not loaded on a net-station.
  238.  
  239.           Name table full:
  240.                 No more slots are available in the local session
  241.           table. Reconfigure the network and then re-boot.
  242.  
  243.           NetBIOS not active:
  244.                 NetBIOS was not loaded or not responding.
  245.  
  246.           No resource available:
  247.                 Too many TSRs are using resources that are necessary
  248.           for the network to operate properly. Notice than some pro-
  249.           grams take-over the system's timer-interrupt and therefore
  250.           don't allow the network software to get any CPU time. Other
  251.           programs actually destroy any interrupt vectors that exist.
  252.           Such programs can't be used in a networking environment. To
  253.           find such programs, attempt to operate with no TSRs on the
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.                                      - 4 -
  265.  
  266.                                                         TESTNET Page 5
  267.  
  268.           net-station. Add each TSR until you find the one that des-
  269.           troys your system.
  270.  
  271.           Program is corrupt!
  272.                 The program file was damaged or changed. Obtain a new
  273.           copy from the distribution disk. If the program is altered
  274.           in any way this message will appear.
  275.  
  276.           Reserved name specified:
  277.                 Data corruption occurred causing the presence of
  278.           reserved characters "*" in the name-field.
  279.  
  280.           Session closed:
  281.                 An error occurred which forced the session to be
  282.           aborted.
  283.  
  284.           Session ended abnormally:
  285.                 An error occurred which forced the session to be
  286.           aborted. This usually occurs when the net-station executing
  287.           MCOM is rebooted when MCOM is in use.
  288.  
  289.           Session OPEN rejected:
  290.                 The CALLed name was found, but was busy.
  291.  
  292.           Stack overflow!
  293.                 There are too many TSRs using the user's stack during
  294.           interrupts. This causes the user's stack to grow too large.
  295.  
  296.           Too many commands:
  297.                 The NetBIOS in use was unable to queue more than one
  298.           command at a time. This is a very poor NetBIOS emulation.
  299.  
  300.           Undefined error:
  301.                 Something is getting corrupt which caused NetBIOS to
  302.           return an error-code that is undefined. This can be caused
  303.           by a stack overflow or a TSR that uses memory that doesn't
  304.           belong to it.
  305.  
  306.           The status line on the bottom shows the adapter status from
  307.           the remote net-station (the one you are communicating with).
  308.  
  309.           Re:0000 Ab:004A Co:004F Tx:0FE1291A Rx:0FE11A9B
  310.             |       |       |       |           |_ packets received
  311.             |       |       |       |_____________ packets transmitted
  312.             |       |       |_____________________ collisions
  313.             |       |_____________________________ datagram aborts
  314.             |_____________________________________ retransmits.
  315.  
  316.                 All numbers are hexadecimal.
  317.  
  318.           Running the program.
  319.           You can execute TESTNET overnight to see if there will be
  320.           any problems with aborted sessions. If you use UCOM to set
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                                      - 5 -
  331.  
  332.                                                         TESTNET Page 6
  333.  
  334.           the baud-rate of the UART, you can send many millions of
  335.           bytes in an 8 hour period. At high baud-rates like 9600
  336.           baud, there may be a few data-errors, about one error for
  337.           every 64k of data. At low baud-rates, there won't be any
  338.           errors on a properly operating network. The data errors that
  339.           can occur result from missed hardware interrupts, not data-
  340.           corruption. If you have a fast machine or are using NetBIOS
  341.           software that does not disable interrupts for a long period
  342.           of time, the error-rate will be very low. Connecting a COM
  343.           port with hardware loop-back as is done for this test is a
  344.           worst-case situation because a byte is sent during an
  345.           interrupt-service routine then immediately received, gener-
  346.           ating another interrupt.
  347.  
  348.           - finis -
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.                                      - 6 -
  397.  
  398.  
  399.